home *** CD-ROM | disk | FTP | other *** search
/ APDL Eductation Resources / APDL Eductation Resources.iso / programs / diary_note / calendar_2 / !Calendar / !Help < prev    next >
Encoding:
Text File  |  1993-01-04  |  8.2 KB  |  200 lines
  1. Introduction
  2.  
  3. This application is public domain, it may be copied freely provided that all 
  4. files are kept together. It may not be sold for profit except for a nominal 
  5. handling charge. Portions of the code may be used in your own programs 
  6. providing recognition to the author is given. The author accepts no 
  7. responsibility for any loss or damage resulting from the use of this 
  8. application.
  9.  
  10. This application is intended to create calendars by sending data to 
  11. Computer Concepts document processor (Impression), or any other application
  12. which requests it, using their ImpulseII protocol.
  13.  
  14. Several example calendars are supplied, these may be accessed by clicking 
  15. on the icon bar icon to open the main control window and then clicking on
  16. the 'Calendars' directory icon. Each calendar document contains Impression
  17. Merge commands to request specific information such as the year, month,
  18. week or day. This information is sent to the document by the !Calendar
  19. application.
  20.  
  21. Buttons and Options
  22.  
  23. To create a calendar drag one of the calendar documents, called a template,
  24. onto the main window or onto the calendar icon on the icon bar. The full
  25. pathname of the file will appear in the icon in the centre of the main
  26. window. The Create button will start the merge operation with Impression but
  27. there are several options, controlled by the option icons, which determine
  28. how the calendar is generated. These are explained below.
  29.  
  30. Print :-
  31.         When on this option will cause a Print command to be sent to 
  32.         Impression after the calendar data has been sent to the 
  33.         document. If a printer driver is loaded then the contents of the 
  34.         template, with the merged data, will be printed.
  35.  
  36. Keep Result :-
  37.         This option causes the result of the merge operation to be kept 
  38.         so that you may edit it. This means that the merge commands 
  39.         no longer exist in the document so if you save it you cannot 
  40.         load it in afterwards and generate a different calendar. You 
  41.         should ensure that a copy of your original document, with its 
  42.         merge commands, is kept safe.
  43.  
  44. Use Start/End Month :-
  45.         This option is used when you have a template document 
  46.         which contains Merge commands for only one or two months, 
  47.         and you want to use that document as a template for a range of 
  48.         months. The range used is those months between the values 
  49.         shown in the Start Month and End Month icons at the top of 
  50.         the window.
  51.  
  52. Pause after Merge :-
  53.         This option is handy for examining the results of the merge 
  54.         operation before they are printed or lost. The document is 
  55.         placed in a non-editable state which is shown by the pointer 
  56.         turning into a cross when moved over it.
  57.  
  58. The default options at startup are just Print, with this combination data 
  59. would be sent to the template document and then the results would be 
  60. printed. With Use Start/End Month set as well, a template containing just 
  61. one month would be repeatedly merged and printed.
  62.  
  63. The three sets of "bump" icons at the top of the window control the year 
  64. and the start and end months, the latter two coming into effect with the 
  65. Start/End Month option described above. The year comes up with the 
  66. current year from the real time clock in the computer. Clicking with Adjust 
  67. on any bump icon will perform the opposite action to that of Select.
  68.  
  69. The only icon not mentioned yet is the Cancel button. This will abort the 
  70. current operation and return to the state before Create was pressed. 
  71. Unfortunately, because the message passing which takes place when 
  72. merging is the highest priority event to which the Wimp responds, no 
  73. buttons or option icons will respond whilst merging.
  74.  
  75. Impulse Commands
  76.  
  77. Impulse is a Public Domain high level message passing system written by 
  78. Computer Concepts Ltd. Messages may be passed between applications 
  79. such as Impression II and Minerva's MultiStore database as a means of 
  80. controlling their actions. Contact Computer Concepts for more details.
  81.  
  82. What follows is a list of the commands to which Calendar responds. The first
  83. set of commands do not return a result and so are not meant to be inserted
  84. into an Impression merge command. They are intended for another application
  85. to control Calendar. All except the SetPrefix command are self-explanatory
  86. as they do the same job as their icon namesakes described above. SetPrefix
  87. is provided so that an application other than Impression may be sent the
  88. merge data. The name of the application must be given after the SetPrefix
  89. command then all it needs to do is respond to the Merge, Edit and Print
  90. commands in the same way as Impression.
  91.  
  92. <on/off> may be either 'ON' or 'OFF' the case does not matter. Quit will
  93. shutdown the application in the same way as choosing quit from the icon bar
  94. menu.
  95.  
  96. Look at the template documents for examples of use of these commands.
  97.  
  98. { methods :
  99.     SetOption
  100.         ( -Print <on/off> | -UseMonth <on/off>
  101.         | -Pause <on/off> | -Keep <on/off> )
  102.  
  103.     Cancel
  104.     Quit
  105.     Create
  106.     SetPrefix <string>
  107. }
  108.  
  109. This second set of commands are intended to be used in the merge commands in
  110. the Impression document. <month> may be either the number 1 to 12 or the
  111. name of the month itself e.g. January. Similarly <day> is 1 to 7 or the name
  112. of the day.
  113.  
  114. GetDate is used to get either day numbers (1..31) or the names of days
  115. (Sunday..Monday). The date requested is stated as the month, week number within that month, starting from 1, and optionaly the day.
  116.  
  117. If the day is not specified (no -Day), then a whole week is given starting
  118. from Sunday. If -Format <number> is used, then the names of the days are
  119. returned to the number of characters requested. A text string, enclosed in
  120. double quotes, may be specified, which will be placed before the returned
  121. string.
  122.  
  123. GetWeek is used to return the week number (i.e. 1..53). The month and week
  124. number relative to the start of that month must be specified in the same way
  125. as for GetDate described above. A text string enclosed in double quotes may
  126. be specified which will be placed before the returned string. If the week
  127. number does not apply for the requested month+ week, then a null string will
  128. be returned. This happens on the sixth week in the month most of the time.
  129. Week one is defined as being the first week with four or more days of the
  130. new year in it, where the week starts at Monday.
  131.  
  132. A tab is inserted for days which are blank, i.e. those before the first of
  133. the month and after the end of the month. If the word 'Current' is used then
  134. the month currently selected is used as the one to return the data for. The
  135. word 'Next' can also be used here to select the next month, which is then
  136. returned as the merge data.
  137.  
  138. NextMonth returns null data to Impression, it is used to instruct Calendar
  139. to move onto the next month. This would typically be used at the end of a
  140. template which contained only one month, so that the next merge operation
  141. would start with the next month.
  142.  
  143. Set is another command which returns null data, it is used to force a
  144. particular year, month or range of months to be generated.
  145.  
  146. { methods :
  147.     GetDate
  148.         -Month ( <month> | Current )
  149.         -Week <1..6>
  150.         [ -Day <day> ]
  151.         [ -Format <length of returned string> ]
  152.  
  153.     GetWeek
  154.         -Month ( <month> | Current )
  155.         -Week <1..6>
  156.         " <text> "
  157.  
  158.     GetMonth
  159.     GetYear
  160.     NextMonth
  161.  
  162.     Set
  163.         [ -Month <month> ]
  164.         [ -Year <number> ]
  165.         [ -StartMonth <month> ]
  166.         [ -EndMonth <month> ]
  167. }
  168.  
  169.  
  170. ImpulseII is a trademark of Computer Concepts Ltd           
  171.  
  172. Revision History:
  173.  
  174. 15/2/92:
  175.     First release version 1.00
  176.  
  177. 15/3/92:    version 1.01I
  178.     Added Simon Huntingtons excellent Interface module. Many thanks for
  179.     making this public domain, everyone should use it.
  180.  
  181.     Fixed problem with 'year' writable icon: the year as entered from the
  182.     keyboard was ignored.
  183.                      
  184.     Missed off week six on A4Year document, thanks to Subhash for finding
  185.     this.
  186.  
  187. 26/9/92:    VERSION 1.02I
  188.     Added the "GetWeek" command.
  189.     Made GetDate allow a text string to be added before the returned data.
  190.     Made the Templates icon (the folder) into single instead of double click
  191.  
  192. 4/1/93: Version 1.03I
  193.     Re-initialise Impulse if we cause Impression to be loaded - it may
  194.     contain a later version of Impulse.
  195.     Update to version 0.18 of Impulse.
  196.  
  197. © Dale Cass 1992,1993
  198. © SFC 1992,1993
  199.  
  200.